CrunchDir v1.26 (05.04.98) ---------------------------- Anleitung ----------- =========================================================================== 0. Inhalt --------------------------------------------------------------------------- 1. Vorwort 2. Was macht CrunchDir 3. Systemanforderungen 4. Installation 5. Parameter 6. Autor 7. Danksagungen =========================================================================== 1. Vorwort --------------------------------------------------------------------------- Dieses Programm und alle im Paket befindlichen Dateien sind © 1997/98 by Thomas Knuppe. Sie dürfen frei kopiert werden solange das Archiv und alle in ihm enthaltenen Dateien unverändert bleiben. Ich, der Autor dieses Programmpakets, übernehme keine Haftung für irgendwelche Schäden, die während oder nach der Benutzung dieses Programms entstehen. Das Programm wurde mit Amiga_E auf einem Amiga 4000/030 mit OS3.1 geschrieben und ausgiebig auf einem A4000 und A3000T getestet. Sollte es dennoch fehlerhaft arbeiten bitte ich, mich zu benachrichtigen. =========================================================================== 2. Was macht CrunchDir --------------------------------------------------------------------------- Ich habe CrunchDir geschrieben, da es meinem BBS-Programm (AMMS) nicht möglich ist Binärbrettinhalte nach Menge oder Haltezeit (sprich in irgendeiner Form dynamisch) zu verwalten. Crunchdir scannt rekursiv ein übergebenes Verzeichnis nach Dateien die ein bestimmtes Alter überschreiten. Diese Dateien werden dann sofort gelöscht. =========================================================================== 3. Systemanforderungen --------------------------------------------------------------------------- Das Programm benötigt lediglich einen Amiga mit OS2.04 (oder besser) und mindestens eine 68000 CPU. CrunchDir läuft auf 2 Mailboxsystemen in täglichem Einsatz absolut problemlos. =========================================================================== 4. Installation --------------------------------------------------------------------------- Die Installation ist denkbar einfach: Das Programm 'CrunchDir' in das C: Verzeichnis kopieren. Puuh - und jetzt die Schweissperlen von der Stirn wischen :-) =========================================================================== 5. Parameter --------------------------------------------------------------------------- Dem Programm können/müssen folgende Argumente übergeben werden um die Arbeitsweise zu beeinflussen : Template : DIR/A,PATTERN,DAYS=D/K/N,LOGFILE=LOG/K,NOTIME/S,ADDLOG/S: DIR/A : Das zu durchsuchende Verzeichnis. Das Programm geht dabei rekursiv jedes Unterverzeichnis durch. Dieses Argument _MUSS_ angegeben werden. Wird ein Leerstring übergeben, scannt das Programm automatisch im aktuellen Pfad! PATTERN : AmigaDOS-Pattern um die zu beeinflussenden Dateien auszuwählen. Z.B. würde (b#?) nur alle Dateien scannen, die mit einem 'b' anfangen. ACHTUNG: Dieser Pattern ist Case-Sensitiv, d.h. es wird zwischen Groß- und Kleinschreibung unterschieden !! Wird dieses Argument weggelassen, geht das Programm davon aus, dass jede Datei gescannt werden soll (was dem Pattern "(#?)" gleichkommen würde). Wie vom AmigaDOS gewohnt, sind auch negierte Patterns möglich (z.B.: ~(#?.txt) ). DAYS=D : Mit diesem Argument übergibt man dem Programm die Anzahl der Tage, die vom aktuellen Datum abgezogen werden sollen um das Mindestalter der zu löschenden Files festzulegen. Das klingt komplizierter als es ist. Beispiel: Es sollen nur Dateien gelöscht werden die älter sind als 20 Tage : D=20 Dieses Argumment ist ein sogenanntes KEYWORD. Es muss bei der Angabe mit übergeben werden. Beispiele wären: DAYS=10 , D 5 , D=70 Wird dieses Argument nicht übergeben oder überschreitet die Tagesangabe das aktuelle Datum, benutzt das Programm die Standardeinstellung von 30 Tagen. LOGFILE=LOG : Durch Angabe dieses Schlüsselwortes und eines Dateinamens wird ein Logfile unter dem angegebenen Dateinamen generiert. Beispiel: LOG="RAM:CD-LOG.TXT" Während des benutzens von CrunchDir wird zusätzlich eine temporäre Datei "CD-LOG.TMP" im logischen Verzeichnis T: angelegt. Diese Datei wird beim Beenden von CrunchDir automatisch entfernt Das Logfile erhält zusätzlich einen Dateikommentar, der Aufschluss darüber gibt wieviele Dateien gelöscht wurden und ob Fehler aufgetreten sind. NOTIME/S : Damit kann die Uhrzeit (die einer Datei und die des aktuellen Datums) ignoriert werden. Dadurch werden nur Dateien gelöscht, die tatsächlich x Tage alt sind. ADDLOG/S : Durch diesen Schalter kann ein neu erzeugtes Logfile (siehe Parameter "LOGFILE") an ein bestehendes angehängt werden. Die einzelnen Einträge werden räumlich voneinander getrennt und mit eigenem Header versehen. Der Filekommentar (siehe Parameter "LOGFILE") enthält bei diesem Parameter nur Informationen über den letzten Aufruf von CrunchDir ! Beispiel für einen Aufruf des Programms: Crunchdir Files:Stuff ~(BOARDINFO#?) D=2 LOGFILE T:Crunchdir.log Dieser Aufruf würde alle Files im Verzeichnis "Files:Stuff" (und darunterliegenden Verzeichnissen) , die älter als 2 Tage sind, löschen. Davon ausgeschlossen werden Dateien, die mit "BOARDINFO" anfangen oder genauso heissen. Zusätzlich wird ein Logfile unter dem Namen "Crunchdir.log" im logischen Verzeichnis T: erzeugt. Die Uhrzeit der zu löschenden Datei(en) und die des aktuellen Datums werden zur Zeitberechnung benutzt. Die Uhrzeit kann mit dem Schalter NOTIME/S (siehe oben) ignoriert werden. ACHTUNG !! Das Programm löscht nur Dateien die ohne weiteres Zutun gelöscht werden können. D.h. die Protection-Bits einer Datei bleiben unverändert. Wenn eine Datei also z.B. vor löschen geschützt ist, wird sie einfach ausgelassen. Eine Fehlerausgabe findet nur statt, wenn zusätzlich ein Logfile generiert wird ! =========================================================================== 6. Autor --------------------------------------------------------------------------- Dieses wunderbare Programm hat geschrieben : Thomas 'Shadow' Knuppe aus Berlin, Deutschland Ich bin unter folgenden Adressen erreichbar : E-Mail : EsHaDe@gmx.de Home : http://home.pages.de/~shd IRC : 'sHD' oder 'EsHaDe' on IRCNet FAX : +49 (0)30 667 09 543 BBS : Outside world - +49 (0)30 667 09 150 X.75 667 09 151 v34+ 667 09 543 v32b/ZyX +FAX [AMMS 3] 667 09 544 v32b =========================================================================== 7. Danksagungen --------------------------------------------------------------------------- Mein Dank geht an folgende Personen: Till 'MacGyver' Klöpping - Ohne Deine Routinen wäre ich wohl nicht so schnell dahintergestiegen :) Ronny 'Cannon' Schulz [IDP!] - Der wahrscheinlich die bisher besten Tools für AMMS geschrieben hat und hoffentlich weiterhin schreiben wird. Roman 'Galax-e' Harneit - Für alles was wir bisher 'gemeinsam' durchgestanden haben =) 1997 rules ! Rolf 'Digi-Bit' Müller - Für die Verbesserungsvorschläge ... Enya - Für die entspannende Musik beim Proggen =) Wouter van Oortmerssen - Für die genialste Programmiersprache überhaupt :) (Amiga_E) ------------------------------------------------------------------------------